home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / ansi320.zip / ANSIART.DOC < prev    next >
Text File  |  1992-09-19  |  14KB  |  379 lines
  1.                         ANSi Art Gallery version 3.20
  2.                                 Documentation
  3.                             Programmed by Roger Hu
  4.  
  5.  
  6. NOTE:   ANSi Art Gallery requires the ANSI.SYS device driver to be
  7.         installed. The program is not dependent on a FOSSIL driver.
  8.  
  9. ────────────────
  10.   Installation
  11. ────────────────
  12.  
  13. 1.   Make a new directory called ANSIART under your main BBS directory.
  14.  
  15. 2.   Unpackage ALL files into the ANSIART directory.  All files must be
  16.      present.  Consult FILES.AAG for complete file listing.
  17.  
  18. 3.   Run ARTINST.EXE.  You will be asked four questions about your system
  19.      and the setup will be easily finished.
  20.  
  21.      DSZ Path
  22.      ────────────────────────────────────────────
  23.      ANSi Art Gallery uses DSZ for its protocol(s) when uploading or
  24.      downloading.  Make sure you know where DSZ.COM or DSZ.EXE is located
  25.      before you run the installation program.
  26.  
  27.      Temporary directory
  28.      ────────────────────────────────────────────
  29.      ANSi Art Gallery uses the temporary directory for temporarily storing
  30.      files users upload or download.  Make sure this directory is EMPTY!
  31.      The door will erase ALL files in this directory when it is run by a
  32.      user or the sysop.
  33.  
  34.      Validation of ANSi's uploaded to the door
  35.      ────────────────────────────────────────────
  36.      This will specify whether or not you want to validate files yourself.
  37.      Answer (Y)es if you want to leave files unvalidated.  This means that
  38.      each time a file is uploaded to ANSi Art Gallery, it will not be
  39.      accessible to any users until validated by the sysop (by renaming
  40.      x.NEW to x).  Registered sysops have a special function that will
  41.      validate files.  See Registration Information for details.  Answer
  42.      (N)o if you want to have files auto-validated.
  43.  
  44.      NOTE: The unregistered version of ANSi Art Gallery will only accept up
  45.            to 10 ANSi's.
  46.  
  47.      PKZIP path
  48.      ────────────────────────────────────────────
  49.      This is used when ANSi Art Gallery prompts the user whether or not to
  50.      compress all files into a ZIP file.  This will minimize transfer time
  51.      and is an added feature in version 3.20.
  52.  
  53. 4.   This section is for REGISTERED USERS:
  54.  
  55.      Create a file called REGISTER.CFG.  Enter the registration name on the
  56.      first line, and the registration number on the next line.  Make sure
  57.      you type in the BBS name EXACTLY as it appears on the registration
  58.      form, Ensure all spelling and capitalizing is correct.
  59.  
  60.         Sample REGISTER.CFG:
  61.  
  62.         ANSi Art Gallery Registered
  63.         11111
  64.  
  65.  
  66.      Using your favorite text editor, load/create SYSOP.LST.  Enter all the
  67.      user names that will be able to access the Sysop Functions ('%' from
  68.      main menu).  If the user is not in the SYSOP.LST file, the [%][Sysop
  69.      Functions] will not be displayed and cannot be accessed.
  70.  
  71.         Sample SYSOP.LST: (Not case-sensitive)
  72.  
  73.         Roger Hu
  74.         Sysop
  75.  
  76.  
  77. 5.   ANSIART  <DoorInfoFile> [PORT:<ADDRESS>:<COM port>]
  78.  
  79.         Sample command line for use with a Door Info file
  80.            and standard COM port:
  81.  
  82.         ANSIART C:\BBS\PCBOARD.SYS
  83.  
  84.  
  85.         Sample command line for a non-standard COM port 3
  86.            at Hex address "03e8":
  87.  
  88.         ANSIART C:\BBS\PCBOARD.SYS PORT:03E8:3
  89.  
  90.  
  91.      ANSi Art Gallery, supports many BBS systems.  If the BBS system you
  92.      are using can support at least one of the following files, then ANSi
  93.      Art Gallery should work with:
  94.  
  95.         Door Information File                 BBS Software
  96.         ─────────────────────             ─────────────────────
  97.            DORINFOx.DEF                    RBBS, QBBS & others
  98.            DOOR.SYS                        Telegard, GAP, TAG
  99.            CALLINFO.BBS                    WildCat!
  100.            CHAIN.TXT                       WWIV
  101.            PCBOARD.SYS                     PCBoard
  102.  
  103.  
  104.                                   That's it!
  105.  
  106.  
  107. ─────────────────
  108.   FOSSIL Driver
  109. ─────────────────
  110.  
  111. If you would like to use a FOSSIL driver to speed up the program, or have a
  112. non-standard port with ANSi Art Gallery, the parameters are as follows:
  113.  
  114.      ANSIART <DoorInfoFile> [PORT:F:<COM port>]
  115.  
  116.         Sample command line to use a FOSSIL driver on COM1:
  117.  
  118.         ANSIART C:\BBS\PCBOARD.SYS PORT:F:1
  119.  
  120.  
  121. ─────────────
  122.   UART Chip
  123. ─────────────
  124.  
  125. Thanks to Rickie Belitz, ANSi Art Gallery will enable the 16550 or 16550A
  126. UART Chip if present.
  127.  
  128.  
  129. ────────
  130.   OS/2
  131. ────────
  132.  
  133. Although ANSi Art Gallery does not use 32-bit operations, ANSi Art Gallery
  134. should still work under OS/2.  This program has been tested and compiled
  135. under OS/2.  Should problems arise, please contact the listed support
  136. sites.
  137.  
  138.  
  139. ──────────────
  140.   Sysop Keys
  141. ──────────────
  142.  
  143.            Function key         Action Performed
  144.            ────────────         ──────────────────────────────────────────
  145.              * F3               Toggle printer on/off
  146.              * F4               Toggle pagebell on/off
  147.                F5               Shell to DOS
  148.              * F7               Toggle caller alarm on/off
  149.                F8               Return user to system
  150.                F9               Toggle display on/off
  151.                F10              Chat mode  (use the ESCAPE key to exit)
  152.  
  153.            Alternate key        Action Performed
  154.            ────────────-        ──────────────────────────────────────────
  155.                ALT-H            Toggle between different status lines
  156.              * ALT-N            Toggle sysop on next
  157.              * ALT-X            Toggle exit to dos after call
  158.                                    and help lines
  159.  
  160.         Alternately pressing the ALT-H key will bring up the next status
  161.         line screen.  The 1st screen is a help screen, the second second
  162.         screen shows your COM port status.
  163.  
  164.     *  The function keys marked with an "*"  will only be of use to systems
  165.        using PCBOARD.SYS.  The rest are functional with any system.
  166.  
  167.  
  168. ──────────────
  169.   Protection
  170. ──────────────
  171.  
  172. I have attempted to add as much protection to your system as possible.
  173. Users may attempt to send files to a different directory while batch
  174. uploading. Using the "restrict" command in DSZ, I have minimized, if not
  175. eliminated, the possibility of users tampering with the BBS.  However, I
  176. offer no responsibility if a user somehow is able to harm the system.
  177.  
  178. When a user selects a "single file upload" protocol, the user is prompted
  179. to enter a filename.  This filename, to help prevent any hackers, is first
  180. split apart into directory, drive, filename, and extension.  The filename
  181. and extension are then put together, and the directory and drive are
  182. excluded. This is an extra security measure for sysops.  This also applies
  183. when a user attempts to view an ANSi file.
  184.  
  185.  
  186. ───────────────
  187.   Error Codes
  188. ───────────────
  189.  
  190. ANSi Art Gallery will return an Errorlevel and display an error message if
  191. something went wrong during execution.  Here are what they correspond to:
  192.  
  193.         Errorlevel     Meaning
  194.         ──────────     ──────────────────────────────────────────────
  195.             0          Successful execution
  196.             1          Unable to open BBS system file
  197.                           (PCBOARD.SYS, DOOR.SYS, etc.)
  198.             2          Problem reading BBS system file
  199.             3          Unrecognized BBS file type
  200.             4          Unable to open PCBOARD USERS file
  201.             5          Invalid User record or
  202.                           problem seeking to user record
  203.             6          Problem reading USER record
  204.             7          PORT command syntax error
  205.             8          FOSSIL driver specified but no FOSSIL driver
  206.                           installed
  207.             9          Memory allocation problem
  208.  
  209. If you still continue to have problems, contact one of the boards listed
  210. below for help.  Make sure you have the Errorlevel on-hand when you log in.
  211.  
  212.  
  213. ────────────────────────────
  214.   Registration Information
  215. ────────────────────────────
  216.  
  217. NOTE: Prices are subject to change.  Offer expires August 1, 1993.
  218.  
  219.         ***   ANSi Art Gallery has lowered its registration fee!   ***
  220.  
  221.            Registration is only $5(US Dollars).  If you
  222.            register ANSi Art Gallery, you will receive:
  223.  
  224.         ■  Support for ANSi Art Gallery - Support will be given as long as
  225.               ANSi Art Gallery is maintained by the authors.
  226.  
  227.         ■  Ability to catalog, upload and download an unlimited number of
  228.               ANSi's.
  229.  
  230.         ■  Registration code to personalize your copy of ANSi Art Gallery
  231.               with your BBS name.
  232.  
  233.         ■  Remote/local Sysops functions.  This is an added feature
  234.            allowing you to edit, insert, and delete ANSi records.  (See
  235.            PREVIEW.ANS to find out what these added functions are!).
  236.  
  237.  
  238. ═════════════════════════════════════════════════════════════════════════════
  239. Registration Form                                       ANSi Art Gallery 3.20
  240.  
  241.  
  242. Basic Registration                                [ ] $  5.00
  243.  
  244. ANSi Art Gallery Latest Version
  245.                    5 1/4" disk                    [ ] $  3.00
  246.                    3 1/2" disk                    [ ] $  5.00
  247.  
  248.    NOTE: If you would like the latest version of ANSi Art Gallery
  249.          without having a disk sent, you may call any of the sites
  250.          and download it. If you have a FidoNet address, you may
  251.          request the file from address 1:161/704 (The Dark Side
  252.          408-251-0357).
  253.  
  254. Shipping for orders outside North America         [ ] $  5.00
  255.                                                      ══════════
  256.  
  257.         Total Amount Enclosed                         $ __.__
  258.  
  259. (Expect at least 2 weeks delivery time for disks orders)
  260.  
  261. If you only mark the first box, then a letter with your registration code
  262. will be included.  If you would like an updated version of ANSi Art Gallery
  263. with your registration, mark the second and/or third box.
  264.  
  265. Name to be registered to: __________________________________________
  266.  
  267. BBS Name: __________________________________________________________
  268.  
  269. FidoNet Address (if any): __________________________________________
  270.  
  271. Address: ___________________________________________________________
  272.  
  273.          ___________________________________________________________
  274.  
  275.          ___________________________________________________________
  276.  
  277. Where did you get this program? ____________________________________
  278.  
  279.          ___________________________________________________________
  280.  
  281. BBS Number: (___)___-____
  282.  
  283. Comments or Suggestions:____________________________________________
  284.  
  285. ____________________________________________________________________
  286.  
  287. ____________________________________________________________________
  288.  
  289. ____________________________________________________________________
  290.  
  291. ____________________________________________________________________
  292.  
  293.  
  294. Send registration fees to:
  295.  
  296.         26705 St. Francis Drive
  297.         Los Altos Hills, CA 94022
  298.         RE: Registration of ANSi Art Gallery
  299.  
  300. Make checks payable to Roger Hu
  301.  
  302. ═════════════════════════════════════════════════════════════════════════════
  303.  
  304. Questions, Comments, or Suggestions can be answered by contacting the
  305. following boards listed below:
  306.  
  307. The Dark Side      (408)251-0357 14.4k Dual Std    Alpha Center I    TeleGard
  308. Social Distortion  (415)343-1501 14.4k Dual Std    Alpha Center II   TeleGard
  309. The Fast Tracks    (408)739-5781 14.4k v32/v32bis  Alpha Center III  TeleGard
  310. Omega-One BBS      (601)287-1336 14.4k Courier HST Beta Center I     WildCat!
  311.  
  312. For information or help with ANSi Art Gallery Network Interface,
  313. call The Dark Side.
  314.  
  315. Try to contact the alpha centers before attempting to leave a message on
  316. Omega-One, since letters written to me on Omega-One may take some time to
  317. obtain a response.
  318.  
  319. The latest versions of ANSi Art Gallery may be downloaded from any of these
  320. support sites.
  321.  
  322.  
  323. ───────────
  324.   Credits
  325. ───────────
  326.  
  327. Original Programming by Stanley Hu
  328. Thanks go out to Jedi for revising the documentation files.
  329. Programmed in Turbo C with modem routines by Rickie Belitz.
  330.  
  331. Turbo C is a registered trademark of Borland International, Inc.
  332. PCBoard is a registered trademark of Clark Development Company.
  333. WildCat! is a registered trademark of Mustang Software.
  334. SpitFire is a registered trademark of Buffallo Creek Software
  335. RBBS-PC is copyright(c) Tom Mack, Capital PC Software Exchange.
  336. QuickBBS is copyright(c) Adam Hudson.
  337. DSZ is a registered trademark of Omen Technology.
  338. OS/2 is a registered trademark of IBM Corporation.
  339.  
  340. You are running ANSi Art Gallery at your OWN RISK.  The authors of AAG are
  341. not liable for any damages caused by this program.
  342.  
  343. No portion of this distribution package should be sold for any sort of
  344. profit nor may any portion be distributed with modification without the
  345. prior written consent of Roger Hu.
  346.  
  347. I strongly suggest using PKSFANSI(tm) by Phil Katz.  This program prevents
  348. keyboard reassignments (also known as ANSi bombs) from uploads by malicious
  349. users attempting to do harm to your system.
  350.  
  351.  
  352. ──────────────────
  353.   Modifications
  354. ──────────────────
  355.  
  356. Here are several modifications that may be in future releases:
  357.  
  358.         ■ There will be an unlimited number of ANSi's supported.  Organizing
  359.           and sorting of ANSi's will need to be rewritten.
  360.  
  361.         ■ The batch downloading will be revised with windows.
  362.  
  363.         ■ Chat mode will hopefully support word wrap and perhaps a two
  364.           way/color chat will be implemented.
  365.  
  366.         ■ EMS/XMS Support for uploading and downloading.
  367.  
  368.         ■ Any commonly used BBS System not supported by ANSi Art Gallery.
  369.  
  370.  
  371. ───────────────
  372.   Definitions
  373. ───────────────
  374.  
  375. ANSi - A computer text file using the driver ANSI.SYS to display color
  376.        graphics and text.
  377.  
  378. AAG  - ANSi Art Gallery
  379.